My first time going through these steps I didn't change this "release" to the actual version that the .dmp file was built for, which I think is the reason I got an {"detail":"invalid minidump"}% result.

Not sure if the advanced users that would use this method of sending minidumps would make the same mistake, but still might be something worth highlighting.

Other than that, these instructions seem fine as a beginner's guide.

My first time going through these steps I didn't change this "release" to the actual version that the .dmp file was built for, which I think is the reason I got an {"detail":"invalid minidump"}% result.

The main reason you could get an "invalid minidump" (besides the obvious attaching an invalid minidump file 😅) is probably due to bad escaping or delimiting characters because those could prevent the receiving parser from "seeing" the minidump field.

Correctly formed meta-data shouldn't affect the validity of the minidump (i.e., Sentry doesn't cross-check the release in the sentry field with the contents of the minidump).

This is why documenting this as a solution is a double-edged sword. Manually constructing a multipart body can quickly introduce encoding errors like turns out I used ” instead of ". Thankfully, that error appeared when parsing the JSON metadata (with a slightly better error message).

But if the encoding error appears beyond the field value boundary (forgetting the correct number of \r\n and similar), you might get the results of a wrongly parsed HTTP request.

I think the best solution to the problem would be to let relay

• check if the file uploaded as upload_file_minidump is a gzip and in that case
• unzip the file and then validate it as a minidump and continue processing as it does now

This would allow users to apply the same upload methods as described in the previous sections, but instead of uploading a mini.dmp, they would upload a mini.dmp.gz (identified via the first n-byte header).

Until that solution is implemented and deployed, users have a documented approach for uploading minidumps manually.